home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d2 / to_ret.arc / TO-RET.DOC < prev    next >
Encoding:
Text File  |  1988-10-20  |  16.4 KB  |  711 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.                                    TO - RETURN
  22.  
  23.                                    Version 1.1
  24.  
  25.  
  26.  
  27.                         Directory Changing Utility for the IBM
  28.                         Personal Computer and Other Compatibles
  29.  
  30.                                     ---------
  31.  
  32.  
  33.  
  34.                                   User's Manual
  35.  
  36.  
  37.                               (c) 1988 PC Soft-Tech
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.                               Table of Contents
  78.  
  79.  
  80.  
  81.  
  82.         Introduction/Overview.......................................1
  83.  
  84.         How TO.COM and RET.COM Work.................................2
  85.  
  86.         How to Use TO.COM ..........................................3
  87.  
  88.         How to Use RET.COM .........................................4
  89.  
  90.         Sample - The TO.TRE File....................................5
  91.  
  92.         System Requirements.........................................6
  93.  
  94.         Disclaimer..................................................7
  95.  
  96.         Registration................................................8
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                                                  PAGE 1
  137.  
  138.  
  139.        -- Introduction/Overview --
  140.  
  141.           TO - RETURN is a utility to help the user move around the
  142.           various directories and drives of their PC in a fast,
  143.           efficient manner.  It eliminates the need for typing long path
  144.           names with the DOS Change Directory (CD) command.  TO.COM and
  145.           RET.COM may also be used in batch (.bat) files such as
  146.           autoexec.bat or menu systems.
  147.  
  148.           Unlike many similar utilities, TO - RETURN is NOT sensitive to
  149.           one drive only.  As many as five drives can be accessed at any
  150.           time with TO - RETURN. Even the order in which to process the
  151.           drives can be specified with TO - RETURN.
  152.  
  153.           TO - RETURN has the added capability of being able to go back
  154.           to the last drive/directory the user was working in by simply
  155.           typing "RET".  And not only once, but three times to the last
  156.           three drives/directories to be made current with the TO
  157.           command.
  158.  
  159.           TO - RETURN has a simple description of how to use the program
  160.           included on-line simply by typing "TO".
  161.  
  162.           TO - RETURN is available as share-ware from many public
  163.           bulletin board systems.  The user may register his/her copy by
  164.           sending $10.00 to:
  165.  
  166.                    PC Soft-Tech
  167.                    P.O. Box 742
  168.                    Mequon, WI  53092
  169.  
  170.           Registration of TO - RETURN gives to user the following
  171.           additional benefits:
  172.  
  173.               o    Support by phone, mail, or PC Soft-Tech's private
  174.                    bulletin board.
  175.  
  176.               o    Notice of significant upgrades or bug fixes.  You
  177.                    will be notified by mail for any such updates.  There
  178.                    will be no charge for updates as long as you send us
  179.                    a diskette and return postage.  You may also receive
  180.                    a free update through the PC Soft-Tech Bulletin
  181.                    Board.
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.                                                                  PAGE 2
  203.  
  204.        -- How TO.COM and RET.COM Work --
  205.  
  206.           TO.COM and RET.COM are written in Assembler language and are
  207.           therefore extremely fast in operation.  When TO.COM is started
  208.           for the first time (or in subsequent updating), a file TO.TRE
  209.           is created in the root directory.  This file contains three
  210.           pieces of information used by TO.COM and RET.COM.  On the
  211.           first line of the file is information regarding the drives to
  212.           be processed by TO.COM and RET.COM.  The next three lines of
  213.           the file contain the last three drive/directories moved to
  214.           with the TO or RET command.  The rest of the file contains a
  215.           snapshot of the users directory tree.
  216.  
  217.           When the TO command is issued, followed by a string (full or
  218.           partial path name - see page 3) representing the
  219.           drive/directory to move to, the TO.TRE file is searched for
  220.           the for the drive/directory and automatically issues the DOS
  221.           command to move to that directory.  The TO.TRE file is then
  222.           updated to record the directory moved to.  If multiple
  223.           directories contain the identical string, TO.COM will move the
  224.           user to the first directory it finds containing the requested
  225.           string.
  226.  
  227.           When the RET command is issued, the TO.TRE file is searched
  228.           for the last directory moved from that is stored in the file
  229.           and issues the DOS command to move to that directory.  The
  230.           TO.TRE file is then updated and rearranged so that subsequent
  231.           issuing of a RET command will continue to move the user
  232.           through the last three directories used in the same continuing
  233.           order until another TO command is issued.
  234.  
  235.           A number of error messages have been included in the
  236.           programs to notify the user of any problems the program is
  237.           having with executing the commands as typed by the user.
  238.           These error messages include, NO MATCHING DIRECTORY FOUND,
  239.           DRIVE LETTER ENTERED DOES NOT EXIST ON THIS SYSTEM, TO.TRE HAS
  240.           BEEN CORRUPTED, INVALID DIRECTORY TREE - RESCANING, etc.
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.                                                                  PAGE 3
  269.  
  270.       -- How to Use TO.COM --
  271.  
  272.           TO.COM should be placed on the users hard disk in a utility
  273.           directory or some other directory which is contained in a path
  274.           statement installed in the root directory's autoexec.bat file.
  275.           Otherwise the TO command will only work if the user is in the
  276.           directory containing the TO.COM file.
  277.  
  278.           To use TO.COM for the first time, simply type:
  279.  
  280.                    TO /(Drives)
  281.  
  282.           Where (Drives) are a list of drives to be processed by the TO
  283.           command.  Up to five drives may be processed (C,D,E,F,G...)
  284.           in user defined order.  As and example, if the user wishes
  285.           the TO command to include one floppy and two hard drives,
  286.           he/she would type:
  287.  
  288.                    TO /ACD (or TO /CDA to process drive C: first)
  289.  
  290.           This command creates the TO.TRE file used by the program to
  291.           move the user from directory to directory.  If the user wishes
  292.           to update the TO.TRE for added or deleted directories or
  293.           drives, he/she issues the same command used to create the file
  294.           initially.
  295.  
  296.           Once the TO.TRE file has been created, the user can move to
  297.           any directory on their system by typing:
  298.  
  299.                    TO (Path)
  300.  
  301.           Where (Path) can be any full or partial path name.  As an
  302.           example; to move to the directory C:\UTILITY\BATCH\SPECIAL,
  303.           the user could type any of the following:
  304.  
  305.                    to special
  306.                    to ut\spe
  307.                    to ty\tch\ial
  308.                    to bat\spec
  309.  
  310.           If a user attempts to move to a recently added or nonexistent
  311.           directory (not in TO.TRE file), an error message "NO MATCHING
  312.           DIRECTORY FOUND" will be given.  Many other error messages are
  313.           included as part of the TO.COM program to tell the user if an
  314.           invalid drive was specified, or the TO.TRE file has become
  315.           corrupted, etc, to aid the user in running the program.
  316.  
  317.           SPECIAL NOTE: The user must be aware that if he/she wishes to
  318.           move to the root directory c: (or a:, d: etc), the user must
  319.           type the ":" as typing just "to c" will cause the program to
  320.           search for the first directory containing a "c".  As an
  321.           alternative to typing c:, the user may type "to \" to move to
  322.           the root directory of the current drive.
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.                                                                  PAGE 4
  335.  
  336.        -- How to Use RET.COM --
  337.  
  338.           As with TO.COM, RET.COM should be placed on the users hard
  339.           disk in a utility directory or some other directory which is
  340.           contained in a path statement installed in the root
  341.           directory's autoexec.bat file.  Otherwise the RET command will
  342.           only work if the user is in the directory containing the
  343.           RET.COM file.
  344.  
  345.           Unlike TO.COM, RET.COM has no special requirement for first
  346.           time running.  However, TO.COM must have be run to set up the
  347.           TO.TRE file before RET will work.  To return to a directory
  348.           that a user moved from, he/she simply issues the RET command.
  349.           RET.COM uses lines 2 through 4 of the TO.TRE file to review
  350.           the last three directories the user moved to with the TO
  351.           command.  When the RET command is issued, the program will
  352.           execute and move to the latest directory moved from.  This is
  353.           on line 2 of the TO.TRE file.  After the move is complete, the
  354.           program will update the TO.TRE file moving the directories on
  355.           lines 3 and 4 to lines 2 and 3 respectfully.  It then moves
  356.           the directory that was on line 2 to line 4.  In this manner
  357.           the user may return to the last three directories in the same
  358.           order over and over (roll through).
  359.  
  360.           If TO.COM has not been run to set up the TO.TRE file and the
  361.           RET command is issued, an error message "NOWHERE TO RETURN TO"
  362.           will be displayed.
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.                                                                  PAGE 5
  401.  
  402.        -- Sample - The TO.TRE File --
  403.  
  404.           Following is a sample of the TO.TRE File as created for a
  405.           system with one hard drive and one floppy drive.
  406.  
  407.  
  408.  
  409.                    1: DRIVES PROCESSED: CD
  410.                    2: C:\SYMPHONY\FILES
  411.                    3: C:\UTILITY\ARCHIVE
  412.                    4: C:\COMM
  413.                    5: C:\
  414.                    6: C:\ACCNTING
  415.                    7: C:\AST3270
  416.                    8: C:\AST4-02
  417.                    9: C:\CM
  418.                   10: C:\CM\CERTIF
  419.                   11: C:\CM\CMDIR1
  420.                   12: C:\COMM
  421.                   13: C:\DBASE
  422.                   14: C:\SYMPHONY
  423.                   15: C:\SYMPHONY\FILES
  424.                   16: C:\UTILITY
  425.                   17: C:\UTILITY\ARCHIVE
  426.                   18: C:\UTILITY\MACE
  427.                   19: C:\UTILITY\SPF
  428.                   20: D:\
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.                                                                  PAGE 6
  467.  
  468.       -- SYSTEM REQUIREMENTS --
  469.  
  470.  
  471.           TO - RETURN has been successfully run using DOS 2.0 through
  472.           DOS 3.3 and has been run on the following machines (not all
  473.           versions of DOS on all machines):
  474.  
  475.                     o IBM PC
  476.                     o IBM XT
  477.                     o IBM XT/286
  478.                     o IBM AT
  479.                     o IBM PS/2 Model 50, 60 and 80
  480.                     o Compac Deskpro
  481.                     o Leading Edge Model D
  482.                     o Panasonic Business Partner
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.                                                                  PAGE 7
  533.  
  534.        -- DISCLAIMER --
  535.  
  536.  
  537.           The following disclaimer should be viewed as a legal
  538.           obligation on PC SOFT-TECH's part to protect itself.  We by no
  539.           means imply that TO - RETURN is flawed in any way.  We have
  540.           every intention to make modifications and enhancements to
  541.           ensure that TO - RETURN is the best possible product.  If you
  542.           are having problems with TO - RETURN or suspect that it may be
  543.           flawed in any way, notify PC SOFT-TECH and we will make the
  544.           necessary changes as soon as possible, and distribute it
  545.           accordingly.
  546.  
  547.  
  548.  
  549.  
  550.           TO - RETURN is distributed as is, with no guarantee that it
  551.           will work correctly in all situations.  In no event will the
  552.           Author be liable for any damages, including lost profits, lost
  553.           savings or other incidental or consequential damages arising
  554.           out of the use of or inability to use this program, even if
  555.           the Author has been advised of the possibility of such
  556.           damages, or for any claim by any other party.
  557.  
  558.  
  559.           TO - RETURN distribution package, consisting of the program
  560.           and documentation file are copyright (c) 1988 PC SOFT-TECH.
  561.           The author reserves the exclusive right to distribute this
  562.           product, or any part thereof, for profit.
  563.  
  564.  
  565.           Under NO CIRCUMSTANCES may modified versions or disassembled
  566.           versions be distributed, either for profit or in the public
  567.           domain.
  568.  
  569.  
  570.           User's groups, clubs, libraries and clearing houses are
  571.           authorized to distribute TO - RETURN pursuant to the
  572.           following conditions:
  573.  
  574.               1.  No charge is made for the software or documentation.
  575.                   A nominal distribution fee may be charged, provided
  576.                   that it is no more that $5 total.
  577.  
  578.               2.  The program and documentation are distributed together
  579.                   and are not modified in ANY way.
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.                                                                  PAGE 8
  599.  
  600.  
  601.        -- REGISTRATION --
  602.  
  603.  
  604.           Once you become a registered user of TO - RETURN, you will
  605.           receive you will receive the following benefits:
  606.  
  607.             o   Support by phone, mail, or through our private bulletin
  608.                 board system.  Support will only be provided to
  609.                 registered users.
  610.  
  611.             o   Notice of significant upgrades and bug fixes.  You will
  612.                 be notified by mail for any such updates.  There will be
  613.                 no charge for updates as long as you send us a diskette
  614.                 and return postage.  You can also receive a free update
  615.                 through our private bulletin board.
  616.  
  617.  
  618.           Each copy of TO - RETURN is registered for use on one computer
  619.           only and a registered copy is required for each additional
  620.           computer.  The price per registered copy of TO - RETURN is
  621.           $10.
  622.  
  623.           The registered version of TO - RETURN can be used in
  624.           commercial, educational, and governmental institutions.
  625.  
  626.           The free version of TO - RETURN is expressly prohibited for
  627.           use in commercial, educational, and governmental institutions
  628.           except for the purpose of evaluation.
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.                                                                  PAGE 9
  665.  
  666.       -- REGISTRATION FORM --
  667.  
  668.  
  669.         Please add me to the list of registered users, to be eligible
  670.         for support and update notices.  Enclosed is my check or money
  671.         order for $10.
  672.  
  673.  
  674.         Computer Model: ________________________________________________
  675.  
  676.  
  677.         Company Name: ________________________________________________
  678.  
  679.         Your Name:    ________________________________________________
  680.  
  681.         Title:        ________________________________________________
  682.  
  683.         Address:      ________________________________________________
  684.  
  685.         City, State, Zip: ____________________________________________
  686.  
  687.  
  688.  
  689.  
  690.  
  691.         Any initial comments about TO - RETURN?  ________________________
  692.         _________________________________________________________________
  693.         _________________________________________________________________
  694.         _________________________________________________________________
  695.  
  696.         Where did you hear about TO - RETURN?  __________________________
  697.         _________________________________________________________________
  698.         _________________________________________________________________
  699.         _________________________________________________________________
  700.  
  701.  
  702.  
  703.          Send registration form and check or money order to:
  704.  
  705.                    PC SOFT-TECH
  706.                    P.O.  Box 742
  707.                    Mequon, Wi.  53092
  708.                    (414) 241-9119
  709.  
  710.  
  711.